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TERMS OF LICENSE 
AGREEMENT 



Opening this Diskette Package indicates your 
acceptance of these Terms and Conditions. 



All ICR FutureSoft Programs are licensed on an 
"AS-IS" basis without warranty expressed or implied. 

ICR FutureSoft shall have no responsibility or 
liability for any loss or damage caused or alleged 
to be caused directly or indirectly by use of its 
computer software and/or documentation. This 
includes, but is not limited to, the implied warranty 
of merchantability and fitness for a particular 
purpose. 

You may use the program for your own personal 
use. You may not copy or transfer the program 
or any modification, copy or merged portion without 
separate written agreement. 



QUIKPRO+ software programs are protected under 
the Copyright laws of the United States, All rights 
reserved. Reproduction of any part of any program 
is forbidden without the expressed written 
permission of ICR Put tare Soft, 

All ICR Future Soft Programs are licensed on an "as 
Is" basis without warranty. ICR FutureSoft or Its 
affiliates shall have no liability or responsibility to 
customer or any other person or entity with respect 
to any liability, loss or damage caused or alleged 
to be caused directly or limited to consequential 
damages resulting from the use or operation of such 
computer equipment or programs, 
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PREFACE 



This manual has been written to be used by 
programmers and non-programmers alike. Every 
attempt has been made to make this manual easy to 
follow, and special attention has been given to the 
explanation of computer terms which are unfamiliar 
to first-time computer users. 



A special Quik Reference Section has been included 
at the end of the Manual to provide instant 
reference during program operation. Use this 
section often. It will help simplify program use. 
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***** PLEASE READ THIS SECTION ***** 



WHY IS THIS PROGRAM DIFFERENT ? 



QUIKPRO+ is one of the easiest programs to use. 
In minutes you'll be able to create programs for 
filing and data handling without knowing anything 
about programming. QUIKPRO+ is not like any other 
Program, Data Base, File Handler, etc. because you 
get a separate BASIC Program Everytime. 



QUIKPRO+ gives you the complete and total 

flexibility to change any programs that you create 

even after you have created them. You get 
programs that are 100% Customizable. 



You will find that after you have created a 
program using QUIKPRO+, you can easily modify 
your programs because each program contains many 
REMARK Statements to help you get your bearings. 



QUIKPRO+ will save you hours of typing and 
debugging, because when QUIKPRO+ writes 
programs there are no typo errors and debugging. 
Your programs are error free BASIC Programs that 
are ready to RUN or can be easily modified. 
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1.0 INTRODUCTION 



QUIKPRO+ is a complete File Maintenance/Data 
Entry Program Generator. A program generator 
actually writes the program for you. Almost every 
program which uses files to store data requires file 
maintenance. File maintenance generally refers to 
the addition to, updating of, or deletion from a 
file. Since file maintenance is a part of almost 
every program application, a great deal of time is 
used in the production of programs to do file 
maintenance. QUIKPRO+ is designed to eliminate 
the tedious task of hand writing this type of 
program. 



Since file maintenance includes the ability to add 
data to a file, QUIKPRO+'s can produce a program 
which is suited for data entry. Data entry refers 
to the general task of adding data to a file but 
also includes special editing features which make 
entering data easier. These special editing features 
include the verification of data being entered by 
the operator. For example, a data entry program 
might ask the operator to input a Social Security 
Number. Since a number is the only information 
that should be entered for a Social Security 
Number, entering a letter would be incorrect. 
QUIKPRO+'s created Data Entry Programs have the 
ability to check data being entered by an operator 
to make sure that it is the proper type of 
information. 



File maintenance programs produced by QUIKPRO+ 
produce all ASCII data files. ASCII data files 
contain information stored in its most literal form. 
Some files store data in abbreviated form, this 
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makes transferring of the information in these files 
very difficult. Abbreviated file types are not 
standard from one computer system to another 
which accounts for the difficulty in transferring. 
Since QUIKPRO+ files are ASCII and are not 
abbreviated, they may be easily transferred to 
other computer systems. 



QUIKPRO+ is very easy to use. You merely design 

a form on the computer terminal screen which 
conforms to the data required. The QUIKPRO+ 
program itself will ask you while the program is 
being used to enter the information it needs to 
produce the desired program. You are instructed 
by the program. This reduces unnecessary and 

frequent looking up in this User's Manual. 



QUIKPRO+ File Maintenance programs are unique in 
that each program created by QUIKPRO+ requires 
no other special programs or files to operate. 
Each program is a separate BASIC program which 
will run immediately. However, programmers will 
find QUIKPRO+ written programs easy to further 
modify due to extensive documentation (instructions) 
written right in the programs. These instructions 
are contained in Remark statements and will appear 
whenever a program is Listed. (List - refer to 
appropriate BASIC Manual for correct use List) 
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QUIKPRO+ is self documenting. This means that 
after a program has been created by QUIKPRO+, 
you may produce an operator's manual for the 
program just written. The operator's manual is 
automatically written by QUIKPRO+. All that is 
required is a suitable printer attached to the 
computer system. 



In QUIKPRO+ you have the added capability of 
including calculations and/or accumulations in your 
file records, and QUIKPRO+ can also write separate 
BASIC Programs for Reporting from your files or 

other files. 



In addition, QUIKPRO+ includes a handy utility type 

program that allows you to access data from files 
that you might have created beforehand with 
another program. This means that you can write a 
program with QUIKPRO+ to access data that you 
already have, without having to reenter the data. 



This manual will provide you with instructions for 

QUIKPRO+ functions and features. Some helpful 

tips on program uses can be found in the Appendix 
Section of this Manual. 
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2.0 QUIKPRO+ OPERA TION AND STAR T-UP 



Before attempting to use QUIKPRO+, you should 
have some familiarity with the operation of the 
particular computer system you are using. 



You should be familiar with: 

1) How to start the computer system 



2) How to insert Diskettes into the proper 
drive by knowing which disk drive is 1 
or 2, A or B, etc. 



3) How to care for diskettes. 



2.1 Bringing Up_ the B ASIC Language 



If you are unfamiliar with the above then you 
should refer to the owner's and user's manuals 
which should contain the above type of information. 
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2.2 Bringing-Up or Starting QUIKPRO+ 



The following are the instructions for starting 
QUIKPRO+ on your computer. 



IBM Persona! Computer with 2^ Disks 

Put your IBM DOS Diskette with BASIC on it 
into drive A. Put the QUIKPRO+ Diskette 
into Drive B. Turn your computer on. After 
entering the date, type in B:QUIKMENU. 
You should see the QUIKMENU appear on 
your screen. You may go on to section 3.1 
in the manual. 



OSBORNE jAli_ M odels) 

Put a CP/M system diskette with MBASIC 
only on it into Drive A. Put the QUIKPRO+ 
Diskette into Drive B. Turn on or RESET 
(Boot) your OSBORNE. Log on to the B Drive 
by typing in B: . Then type in 

QUIKMENU. Go to section 3.1 in the manual. 
NOTE: Make sure your disk in Drive A has 
MBASIC.COM on it. 



TRS-80 Model III 

Put your TRSDOS Version 1.3 or newer 

diskette into Drive 0. Put the QUIKPRO+ 
Diskette into Drive 1. Turn your computer 
on. After you have entered the date and 
time, type in DO QUIKMENU. You should 
see the QUIKMENU appear on your screen. 
You may go to section 3.1 in the manual. 
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TRS-80 Model I 



Put your TRSDOS Version 2.1 or newer 
diskette with BASIC into Drive 0. Put the 
QUIKPRO+ Diskette into Drive 1. Turn on or 
Boot your computer system. Then type in 
BASIC QUIKMENU. You should see the 
QUIKMENU appear on your screen. You may 
go to section 3.1 in the manual. If you are 
using DOSPLUS, NEW DOS or LDOS, then 
enter BASIC QUIKMENU -F:3. Consult your 
particular manual for additional information 
on these other Operating Systems. 



KAYPRO 

KAYPRO II : Put a CP/M Disk with 
Microsoft MBASIC on it in drive A. Put 
Your QUIKPRO+ Disk into Drive B. Log to 
the B Drive by entering B: . Then type in 
QUIKMENU & Press Return. 

If starting up QUIKPRO+ was not covered in the 
above section, then you will have to follow the 
instructions below and bring up your BASIC 
language on your computer first, and then start up 
QUIKPRO+. 

Since QUIKPRO+ is available on many different 
types of computers, each computer requires a 
different method of starting the BASIC Language. 
Find your system as listed below and bring up your 
BASIC language as indicated: 

C P/M Hardware C P/M (B ASIC 80) 

Log to Drive B by entering B: . Then enter... 
A:MBASIC QUIKMENU /S.-255 
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T RS-80 MODEL _0 TRSDOS 2.0" 

BASIC -F:3 

3.0 R UNNIN G QUIKPRO+ 

After the BASIC language has been brought up on 
the computer you are ready to begin using the 
QUIKPRO+ programs. 

QUIKPRO+ has a Menu which displays the different 
functions that may be performed. 



TO BRING UP THE QUIKPRO+ MENU ON THE 
SCREEN ENTER: 



RUN "QUIKMENU" 



The QUIKPRO+ Program Menu should then be 
displayed on the computer screen. If the menu 
does not appear on the screen, then check to see 
if the QUIKPRO+ diskette is mounted properly in 
the computer system. Some computers may display 
an error message which may indicate the reason for 
the failure of the menu to appear. Consult the 
previous material in this manual to make sure that 
all steps up until this point have been followed 
correctly. 



(c) 1981,1982 ICR FutureSoft 11 



3.1 QUIKPRO+ Menu 



The QUIKPRO+ Program Menu will display five 
options for you to choose from: 



f QUIKPRO+ 
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Program Menu 



( 1) QUIKPRO Filing Program Generator 

( 2) QUIKPRO Automatic Instructions 

( 3) QUIKPrint - Report Program Generator 

( 4) QUIKIndex - File Indexing Utility Program 

( 5) End Program 



V. 



Select - ? 



You make one of the choices from the Program 
Menu. The choices are 1,2,3,4, or 5. The 
following are the descriptions of the programs that 
will RUN when you make your selection from the 
Program Menu: 



M enu Option U_ Start the QUIK PRO+ Filing 

Program Generator. This program is used to design 
your screen and create a complete BASIC Program 
to handle files, manipulate data, calculate and 
accumulate fields. This program should be RUN 
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before any others on the Program Menu, because 
the other programs are dependent on the results of 
the Program you create using this option. 



Men " Option 2%_ Print the Automatic Instruction 
Manual for a program that you created with the 
Program Generator above. This program option will 

print an operator's manual especially for each 
program you create. 



M enu Option 3%_ Q UIKPrint -_ Report Program 

Generator. This option will let you create a 
separate BASIC Report Program from one of the 
filing programs that you might have created above 
in Menu Option i. 



Men " Option k%_ QUIKindex _- File Indexing Utility 
Program. You will only need to use this program if 
you want to use an existing Data File that you 
might have had previously, with a program that you 
created with QUIKPRO+ in Menu Option 1. You do 
not need to use QUIKINDEX at any other time. 



Menu Opti on 5t_ End Program. Selecting this 

option will clear the Program Menu from your 
system and put your computer back into BASIC. 
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fr.Q USING THE QUIKP RO+ FILIN G PROGRAM 
GENERATOR 



The QUIKPRO+ File Maintenance Program 
Generator will begin after being selected from the 
QUIKPRO+ Program Menu. The screen will display a 
form ready for you to lay out. See Figure 4.Q. 



You may design on the screen the particular form 
desired for entering data. Each line on the screen 
is marked with a letter at the left most column of 
the screen. You will see the following message at 
the bottom of your screen... 



Enter the letter of the line you want to 
work with - ? 
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At this time, the cursor (solid block or flashing 
block) is displayed at the bottom of the screen 
immediately following the above message, You may 
move the cursor to the line you want by entering 
the letter of the line you want. The cursor will 
move to the line of the letter you entered. 
Anything that was on that line previously will be 
erased, Once the cursor is at the desired line, you 
can design (layout) the line with the information 
you want. 



A 

B 

C 

D 

E 

F 

G 

H 

I 

3 

K 

L 

M 

N 



Enter the letter of the line you want to 
work on - ? 



Figure 4.0 - QUIKPRO+ Screen with cursor 
(block) shown at bottom. 
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4.1 Designing the Screen Layout 



Once the cursor has been positioned to the line you 
want, you may begin laying out the line. Two types 
of information may be entered on a line: 



1. Literal Data (Graphics on IBM PC) 



2. Fields 



4.2 Literal Data 



Literal Data consist of names, titles, field names, 
symbols or any characters that are not used to 
define input fields. See figure 4.1 for examples. 
Literal data will actually appear on the screen in 
the program you create exactly in the manner and 
position that you design. 



4.3 Fields 



Fields are those areas on the screen that will allow 
something to be entered into them in the finished 
program created by QUIKPRO + . Fields are 
identified by = (equal sign). Continuous groups of 
these characters define a single input field. See 
figure 4.1 for examples. The length of the field is 
determined by the number of continous equal signs 
used. Notice in figure 4.1 that the Social Security 
Number input field on line B is ===== = = ==. This 
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means that the Social Security input field will 
allow a maximum of nine characters to be entered 
into it. You may put more than- one input field on 
any line. 



A Employee File 

B Social Security Number 

C 

D Name ==._=__====-===== 

E 

F Phone Number ==■==■==;= = 

G 

H 

I 

3 

K 

L 

M 

N 



Enter the letter of the Line you want to 
work on - ? 



Figure 4.1 - QUIKPRO+ Screen showing Literal 
Data and three Fields, the first allowing nine 
characters maximum, the second 15 and the third 
13. 



(c) 1981,1982 ICR FutureSoft 17 



il-A Correcting Mistakes on a Line 



Correcting mistakes on a line is a very simple 
matter. If you are typing information on a line, 
you may use the Backspace or left arrow key to 
correct mistakes. Some computers may use a 
different key to correct in-line errors. Consult 
your particular user's manual. 



ij.,5 Correcting Mistakes on an Entire Line 



Correcting mistakes after a line has been entered 
is also a simple process. If a line has already been 
entered, just re-enter the line by typing the line 
number that you wish to correct when the system 
displays the "Enter a line - ?" message at the 
bottom of the screen. 



This will erase the contents of the current line and 
allow you to enter the line again in the way you 

wish. 
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4.6 After Designing Your Screen 



As described earlier the cursor is normally 
positioned at the bottom of the terminal screen. 
When you are designing the screen the "Enter a 
Line - " message is displayed at the bottom of the 
screen. 

When you have finished designing the screen, press 
the ENTER or RETURN key when the program 
requests "Enter a line - ". The system will then 
display the following message: 

"Are you done?" 



If you respond by entering Y for "yes" then the 
QUIKPRO+ Program will continue to the next 
phase. Instructions for the next phase are in the 
next section of this user's guide. 



If you respond by entering N for "no" then the 
previous screen message will be displayed at the 
bottom of the screen. 
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fr.7 Assigning the Primary Key 



Programs created by QUIKPRO+ will allow you to 
add to and update files. Before a record in a file 
can be updated, the record in the file must be 
located. Most files contain records that are keyed 
on a particular piece of information in the record 
for locating purposes. QUIKPRO+ lets you decide 
what item in a files record will be used to locate 
or access the record in your finished program. 



The message: "Which field will be the primary 
key?" 



will be displayed at the bottom of the screen. 
Each field is numbered on the screen. 

Enter the number of the field which will be used 
as the primary key. 



Remember that the Primary Key will be the Field 
in your finished program that will permit you to 
access information in your file very rapidly. (You 
will also be able to locate records in you file by 
searching for data other than that in the Primary 
Key, but fastest access to records in your files will 
come with the Primary Key.) For example, suppose 
the records in your file contained the following 
data: 
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Social Security Number h 
Name 2=============--= 

Address 3=============^= 

City 4==~========4:=;====: 

State 5== Zip 6==^=== 



Note: The numbers correspond to the field 
numbers. 

If you select field number 1 as the primary key, 
then a special file will be created in your program 
allowing you to access information very rapidly 
when using this key field of information, in this 
case, the Social Security Number. In addition, your 
created program will allow you to search on any 
other information in the file. 
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4.8 Assigning Number Fields 



After you have assigned the Primary Key, 
QUIKPRO+ will display: 



"Which fields are numbers only?' 



Some of the Fields which you have designed on 
your screen will only be used to enter data which 
are numbers. If you do not want an operator to be 
able to enter anything in a field that is not a 
number then you may make a Field a Number 
(Numeric) Only Field. 



The Program will ask you to enter the number of a 
Field that you want to be a Number or Numeric 
Only Field. Enter the field numbers one at a time. 



For example, an input field which would contain a 
Social Security Number should contain only numbers. 
By defining the Social Security Number field as 
Numeric Only, you will prevent an operator from 
entering anything into that field that is not a 
number. 



4.9 Assigning the Form of the Number Only Field 



When you have identified a field as Numeric Only, 
you can specify the Format of that Numeric Only 
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field. The format is the manner in which the 
number will be displayed. 

Using Social Security Number again as an example, 
the Format of the Social Security Number Numeric 
Only field will be 9. 



This means that the Social Security Number will be 
displayed as a whole number with no decimal and 
nine characters maximum. 



Note: The Format of a Numeric Only Field may 
include decimals. Examples: 



Format 7 represents a 

whole number 
with seven digits 

Format 7.2 represents a 

decimal number 
with 7 digits to 
the left of the 
decimal and 2 to 
the right. 
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In assigning the Format of a Numeric Only Field, 
you should remember that the total length of your 
Numeric Field must equal the format that you are 
assigning to that field. 



For example, if the length of your Numeric Only 
Field is 3 then the following Formats would be 
acceptable: 1.1, 3, and 2. Remember that the 
decimal must count as one of the digits in the 
total length. 



The system will display the message: 

"Enter the Format of the Number Field - ". 

You should: 

Enter the Format of the input field whose 
number is displayed. 



After you have entered the Format, QUIKPRO+ will 
display: 

"Are any more fields Numeric Only?" 

If you enter Y for "yes", then QUIKPRO+ will ask 
the number of the field that you want to be 
Numeric Only. (See section 4.8) 

If you enter N for "no" then QUIKPRO+ will go to 
the next phase of the program. 
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4.10 Calculation and Accumulation Fields 



QUIKPRO+ permits the inclusion of calculations and 
accumulations. At this point in the program, you 
will be asked: 



"Are any fields calculation fields?" 



If you enter N for "no" then you will proceed to 
the next phase of the QUIKPRO+ Program in the 
next section. 



If you enter Y for "yes" then continue with the 
instructions as follows: 

You will be asked: 
"Enter the field number of a calculated field - " 



Enter the number of a field that you want to 
calculate. If you enter a field number that you 
did not identify as a number only field as described 
in the previous sections, then you will not be able 
to make the field a calculating field, because 
calculated fields must always be number only fields. 

If you enter a valid field number then the computer 
will display: 



"Do you want this calculation to be (S)tored or 
(D)isplayed Only -" 
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Enter an S if you want the calculated field stored 
in your file or a D if you want the calculated field 
to be displayed only on the screen. 

In many cases, calculations do not need to be saved 
in a file, but only displayed on the screen or in a 
report. The calculation itself does not need to be 
stored in the file because the information to 
produce the desired calculation is in the file 
already, and the calculation can be produced from 
the information in the file after it has been 
retrieved or entered. In other cases, you may want 
to update a total or number in a file. In this case 
you would use the (S)tore option. This will be 
explained further. 



After you have indicated whether you want the 
calculation field Stored or Displayed Only, the 
screen will display the following question: 



"Enter the Calculation 



At this point you may enter the calculation you 
want performed in the field number that you 
designated before. Enter the Calculation. 
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4.11 How to Enter a Calculation 



When entering the calculation as requested above, 
you can Add, Subtract, Multiply or Divide numeric 
fields with one another and with other numbers. 
When entering a field in a calculation, the field 
must be entered as follows: 



F#(n) - where n is the number of the field you 
want in the calculation. 



Examples: F#(l) would be field 1 on your 
screen F#(2) would be field 2 on your screen 
etc. 
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Here are some examples of calculations with the 
explanation of each: 



Calculation Description 



F#(l)/10+F#(3) 

Divide Field 1 by 10 then 
Add Field 3 

F#(12)+1000/F#(l)+10.23 

Add Field 12 to 1000 then 
Divide the result by Field 1 
then Add 10.23 to the result 

F# ( 3 ) +F# ( 4 ) +F# ( 5 ) +F# ( 6 ) 

Add Field 3 to Field k then 
Add Field 5 then Add Field 6 

10 * F#(3) 

Multiply 10 by Field 3 



After you enter the calculation for the field you 
desire, the program will delay for a second or two 
to test your calculation. If your calculation is 
invalid, then you will be requested to enter the 
calculation again. An invalid calculation is one in 
which there is an error in the syntax of the 
calculation that you entered. (Note: Brackets 
should not be used around calculations.) If more 
expanded calculations are needed, then they may be 
entered in your created BASIC program after it has 
been created by QUIKPRO+. 
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If you identified the calculated field as one that is 
being Stored, then you may make that stored field 
an accumulation field which is capable of giving 
running balances. 



Example: 



If you have designated Field 3 as a calculated field 
that is to be stored, then these examples will show 
you how to accumulate a field. Field 3 is the 
field we will use for the calculation field in this 
example. 



Calculation for Field 3 Description 



F#(3)+F#(2) 

This calculation will take the 
contents of Field 3 and Add 
Field 2 to it with the total 
being saved in Field 3. To 
state in another way, Field 3 
keeps a running total of 
i tsel f pi us Field 2 . 



After you enter a field calculation, then you will 
be asked again if any other fields are calculating 
fields. You may continue to enter calculation 
fields until you respond N for "no" to the question 
"Are any fields calculation fields?" 



You may change the calculation for a field at any 
time by re-entering the field number and another 
calculation. 
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4.12 Entering Field Comments 



The program will ask you to enter a Field Comment 
for each field that you have created on your 
screen. A Field Comment allows you to describe in 
detail just what information is contained in a 
particular field. You may type up to 30 characters 
to describe each one of your fields. 



The description you enter for field comments will 

appear in the Program Listing that QUIKPRO+ will 

create for you. The field comment will help you 
to locate particular parts of your program. 



4.13 Giving the Data File a Name 



After you have entered a Field Comment for each 
field, QUIKPRO+ will ask you to enter the Name of 
your Data File. Since QUIKPRO+ produces programs 
for filing and data entry, you must have a file to 
store your data. QUIKPRO+ gives you the option 
of naming the file for your data. 

Enter a Data File Name - 



Data File Names may be a maximum of 8 characters 
and contain no numbers. 
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EXAMPLES: 

Good Data Bad Data 

Fi le Names Fi le Names 

DATA DATA 12 345 

FILEDATA File Te 

GOODDATA Bad*Data 



4.14 Giving Your New Program a Name 



Following the step above, QUIKPRO+ will ask you 
to give your new program a name. The Name that 
you give to your program follows the same rules as 
the Name that you have given to your Data File 
above. 



The Name that you give to your program will also 
be used by QUIKPRO+ to create a special screen 
file that you will use to produce the automatic 
instructions in a later portion of this manual. 



For Example: 



If you give your program the name "MYPROG" then 
QUIKPRO+ will create... 



"MYPROG" - which is the actual BASIC Program 
that was created 

"MYPRO G/SC R" - a special file that will be used 
for your Automatic Documentation. (You may also 
use this file to produce other programs if you like.) 
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b.15 Printing a_ Screen W orksheet 



If you have a printer, then QUIKPRO+ can print 
out a copy of the screen that you have created on 
your computer terminal. QUIKPRO+ will ask you if 
you want to print out a screen worksheet. You 
may answer Y or N for "yes" or "no" respectively. 

If you respond Y for "yes" then a copy of the 
Screen you designed with QUIKPRO+ will be printed 
on your printer. 



NOTE: . If__y,ou do not have a printer 
attached, and vou attempt to print out a 
screen worksheet, then you may have t o 
start your program all over again. 



The Screen Worksheet will help you to see the 
specific locations of your data as it is displayed. 



After you have completed the Screen Worksheet 
Phase, then QUIKPRO+ will begin to process some 
information and you will experience a slight delay. 
You will not need to enter any other information. 
QUIKPRO+ will return to the Program Menu by 
itself. 



At this time, your new BASIC Program has been 
completed. You may LOAD, RUN, LIST, or COPY 
it, as you would any other BASIC Program. 
Consult your own BASIC Manual to find out just 
how to RUN a BASIC Program. 
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5.0 USING YOUR NEW PROGRAM 



After all the steps in the previous sections have 
been completed you now have a new program. 



To use your new program simply run it as you 
would any other BASIC Program. Refer to your 
BASIC User's Manual for the correct way to run a 
BASIC Program on your computer system. 



5.1 Program Operation 



Your new program will allow you to Add, Update or 
Delete Data from a Data File which you named 
when you first generated the program. 

When your new program begins running, you will 
see the input form which you designed in the 
beginning. At the bottom of the terminal screen 
will be displayed the functions you can perform 
with your new program. The display will be: 

"(A)dd Record, (G)et Record, (S)earch, (E)nd 
Program" 

You should enter either an A, G, S or E. Make 
sure that vou have the shift on your keyJboa^d__on 
_so that all letters will be entered as capitals. You 
have to press enter when entering one of the above 
letters. 
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5.2 Adding Records to Your New Program 



(A)dd Record will let you do just that. After 
entering the A the cursor will position itself to 
the first input field and wait for you to enter data 
into that field. Pressing the ENTER or RETURN 
keys will move the cursor to the next field until 
you have passed through all fields on the screen. 
Enter data into each field that you pass. Those 
fields which you defined as Numeric Only when you 
created the program using QUIKPRO+ will only 
allow you to enter numeric data into them. Notice 
that if you try to put characters other than 
numbers into a Numeric Only field, they will not be 
accepted. When you have entered the last field on 
the screen, the program will write the record you 
are adding to the file which you defined. You may 
backup to a previous field by entering the < 
character and pressing ENTER. Remember that one 
of the fields on the screen is the key field. 



QUIKPRO+ will permit the use of keys that are the 
same. 



After your record has been added to the file, the 
terminal will display the message indicated in 
Section 5.1 above. 



5.3 Getting Records with Your New Program 



(G)et Record will let you locate a record for 
examination or updating. When the letter G has 
been entered, the program will ask you for the key 
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of the record you wish to access. 
Enter the key. 

If the record is not in the Data File, then a 
message will be displayed on the screen telling you 
that the record was not found. 

If the record has been located, then the entire 
record will be displayed on the screen. 

The program will display: 

"(C)hange, (D)elete - " 

You may: 

Enter C to change a record or D to delete the 
current record. Pressing the ENTER or RETURN 
Key without entering C or D will return the screen 
to the display described in Section 5.1. 
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5A Changing Records with Your New Program 



If you have entered C for change then pressing the 
ENTER Key will move the cursor to each field in 
the record as displayed on the screen. If you do 
not want to change that field, then press the 
ENTER Key again. This will leave the field 
unchanged. If you do want to change a field, then 
enter the new data into the field when the cursor 
is positioned in that field. After you have passed 
the last field, the current record will be updated 
and written back to your Data File with your 
changes. 



5.5 Deleting Records with Your New Program 



If you have entered the D for Delete Record, then 
the record which is displayed on the screen will be 
deleted from the Data File. 

Following either of the above functions, the screen 
will display the messages described in Section 5.1 
above. 
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1A Searching for Records , jn Your New Program 



If you pick the S for Search, then you will have 
the choice of Searching in the following ways: 



Search for Something Anywhere 
in the File (commonly called 
a String Search) 

or 

Search for something in a 
particular Field of the 

File. 



You can Search by Field by entering the letter F, 
or you can Search for Something Anywhere in your 
File by entering a letter A. 



Searching for Something Anywhere jn Your File 
(String Search) 



If you Search for Something Anywhere in your File 
(String Search) then the next message you will get 
on your screen will ask you what you want to 
Search for. 



Simply type in whatever it is you want frj look for. 
If what you type in is found Anywhere in your 
File, then it will be printed on your printer in the 
Form you designed for your report program. 
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Searching for Something in a Field 

If you Search for something in a Field, then you 
will be instructed to move the Cursor to the Field 
that you want to Search on. When the Cursor is 
at the Field that you want, type in whatever it is 
that you want to Search for in that Field. 



If the Field that you are Searching on is a Number, 
then you may perform your Search on the Number 
Field based on whether the Field is Equal to, Less 
than or Greater than the Number that you entered. 



FOR EXAMPLE: Let's say that you have a Field 
that contains ages of various people, and you want 
to print out a report or forms of only those people 
in the File that are greater than 30 years old. 



You would specify that you wanted to Search. 
Then you would enter F for Field Search. Then 
Press the ENTER Key until the Cursor is at the 
Field you want to Search on and type in 30. A 
message will be displayed indicating that the Age 
Field is a Number Field and that you can select 
records that are Equal to, Less than or Greater 
than 30, which is the number you entered. Enter 
the letter G for Greater than. Your printer will 
only print records or forms when the Age Field 
from your File Records is greater than 30. 
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5.7 Ending Your New Program 



(E)nd Program will stop the current program and 
put you back in BASIC. 
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6.0 QUIKPRO+ AUTOMATIC DOCUMENTATION 



QUIKPRO+ will print out an Instruction Manual for 
each and every program that you create. To do 
this, select the option from your QUIKPRO+ 
Program Menu to Print the Automatic Instructions. 



QUIKPRO+ will ask you if you have a printer 
'attached and turned on. If you do not, then you 
should enter N for "no" and you will return to the 
Program Menu. 



If you answer Y for "yes", then QUIKPRO+ will 
ask you for: 

The Name of the Program that you want to Print 
Instructions for. 

If the program does not exist, then you will be told 
on the screen. Remember that QUIKPRO+ uses 
the Screen File that it automatically creates for 
you when you name your program. If the Screen 
File for the program name that you enter above is 
not on your diskette, then you will not be able to 
print instructions. 



Example: 

You enter program name for instructions as 
"MYPROG" 

QUIKPRO+ will look for "MYPROG/SCR" to 
produce your instructions. 

If you have not erased the Screen File, then it 
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should be on your diskette. 

You do not need to enter the "/SCR" after your 
program name, just the program name itself. 

If QUIKPRO+ finds your program name, then you 
will get a complete set of operator instructions on 
how to use the particular program that you 
specified. 
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7.0 QUIKPRINT REPORT PROGRAM GENERATOR 



This is the third option on the QUIKMENU, 
QUIKPRO+ Program Menu. 



PURPOSE: 



This program will let you create a separate BASIC 
program that will print reports. These reports may 
be used to list information that you have in files 
from programs that you created with the 
QUIKPRG+ Filing Program Generator. 



In order to create Report Programs, you will need 

to have available the Screen (SCR) File of the 

original Filing or Data Entry Program that you 

designed using the Data Entry and Filing Program 
Generator. 



When your Filing or Data Entry Program was 
created, an additional file, which we call the 
Screen File was also created on your disk 
automatically. This File has the same name as 
your created program, but has a file extension of 
SCR. ( A file Extension is that part of the file 
name which appears at the end of the name and is 
separated from the first part of the name by either 
a slash mark "/" or period ".") 
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EXAMPLE: If you created ,a Filing or Data Entry 
Program and you named it PROGRAM then the 
Screen File for your Program would have the name 
PROGRAM. SCR. 



How to Create a Report Program 
7.1 Step 1 --Recalling your Screen File 



After you have selected the QUIKPRINT Report 
Program Generator from the QUIKMENU, you will 
be asked if you want to return to the Menu or 
continue. 

If you continue, you will then be asked to enter 
the Name of the Filing Program that you originally 
created (As explained above). 

Enter the Name. 

After you have entered the name, specify which 
Drive the Screen File you will need is on. If your 
Screen File is not located on a diskette currently 
in one of the drives, then a message will appear 
telling you that your Screen File cannot be found. 



The disk you picked will be searched for the 
Screen File. If it is not found, then you will be 
given a message telling you that. 
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7.2 Step 2— What Kind of Report? 
Columnar or Free Form 



Once your Screen File has been found, you will see 
the Screen/Record Layout that you designed when 
you created your original filing program. Ail of 
the Fields will be numbered. 

You will then be asked what Kind of Report 
program you want to create. 

The program will display the question. . . 



Do you want to Create a <F>ree Form or 
<C>olumnar Report Program (C or F) ? 



You may enter either a C if you want to create a 
Report Program that will print out in columns, or 
you may enter an F if you want to create a Free 
Form Report Program. 

A Free Form Report will let you design a form of 
your choosing on your screen. On this form you 
may enter Text and also include Fields from your 
File in your report. 



If you want to create... 

Form Letters, Mailing Cards, Labels or any other 
(c) 1981,1982 ICR FutureSoft W 



Form... 



then you would pick the Free Form Report option. 



If you want to print out a report in Columnar Form 
then you should choose the Columnar Option. If you 
are going to create a Columnar Report Program 
then skip the next sections of this guide and go to 
Section 7.9 titled COLUMNAR Reports. 
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7.3 Step 3a— Free Form Reports 



If you picked the Free Form Report option, then 

you will be asked several questions about your 

form, and you will actually be able to design your 
Form right on the Computer Screen. 



Report Length 

The next question you will be asked is .... 

How many lines do you want this report to use 



Your answer to this question can be any number 
between 1 and 99. The number of lines that you 
enter will be the maximum number of lines that 
could be printed on your letter, form or label. 



The following examples indicate the number of lines 
you should enter for some of the more common 
forms: 



8 1/2" x 11" standard letter size paper has 66 lines 
per sheet 

8 1/2" x 142 legal size paper has 84 lines per 
sheet 
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7/8" or 1" label has 6 lines^ per label 
#10 envelope has 25 lines 

Report Width 



Next, you will need to enter the Width that you 
want for the report in your created program. This 
Width is expressed in Characters per Line. (The 
maximum permitted is different from computer to 
computer, and will be displayed on the screen.) This 
will permit you to design Free Form Reports on 
forms that are the Width of a letter size, i.e. 8 
1/2 inches wide. 



Of course you may enter a Width that is less than 
the maximum. 
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7A Designing the Report 



Next you will be able to Design your Report. You 
will use a method similar to the one you used to 
Design Your Screen when creating your Filing 
Programs. 



You will see a form appear on the Screen that 
looks like this: 



1 
2 

3 

5 

6 
7 



<E>dit Report, <P>rint Report Layout s 
<L>ook at Record Layout, <D>one - 



(We show only 7 lines in the above example. 
Actually, there are as many as your screen will 
permit.) 



Each number displayed down the left hand side of 
your screen corresponds to the same line number on 
your report. 
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The options at the Bottom of the Screen are: 



E - Edit the Report 

P - Print the Report Layout 

L - Look at Record Layout 

D - Done (Finished Report Design) 
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7.5 Option 1_ Editing Report Layout (Form) 



If you choose E, then you will be able to Edit the 
Report Layout. After you Enter E, then you will 
see the message: 



What Line do you want to work on (1-n) 



... displayed at the bottom of your screen. (The 

letter "n" is the number of lines that you entered 

previously as the maximum number of lines for the 
report). 



You may enter any number between 1 and n. When 
you do, you will see the Cursor go to the number 
of the line that you entered, or you may Press 
ENTER and the options will be displayed again at 
the bottom of the screen. 



Once you are on the line that you entered, you 
may type in anything that you want Printed on that 
line in your Report. Whatever you type will appear 
in your report just as you type it. You will be in 
what we will call the Text Mode. 
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Of course you will want to enter some Fields of 
data from your files into the reports that you 
create. 



To do this, simply Press the <CTRL> F Key on 
your Keyboard whenever you are ready to enter a 
Field at the spot that you want it. (If your 
computer keyboard does not have a CTRL Key on 
it, then press the <SHIFT> Key and the Down 
Arrow together and the <F> Key. This will be 
equivalent to <CTRL> F.) 



You will then be asked... 

What Field Number do you want on the line . 



The Field Number you may enter would be the 
Field Number of the Field that you want from your 
Screen/Record Layout. (If you need to refer to the 
Screen/Record Layout to get information on your 
fields, Simply Press the ENTER Key until you 
return to your choice of options at the bottom of 
the screen. Then Pick the L for <L>ook at Record 
Layout. This option is explained in a subsequent 
section.) 



When you enter a good Field Number, that field 
will be displayed on your screen at the point on 
the Screen where you were editing the line. If you 
specify a Field Number that is too large to fit on 
the line, then a message will be displayed for you 
at the bottom of the screen. 



You may continue Editing your Report Form until 
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you have designed it just the way you want it. 



When you have finished, simply Press the ENTER or 
RETURN Key when you are asked the question, 
"What line number do you want to work on." You 
will then be given your options as listed previously. 
(<E>dit Report, <P>rint Report Layout, <L>ook at 
Record Layout, <D>one - ) 
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7.6 Option 2 Print the Report Layout 



This option will let you print out a copy of the 
Report Layout that you are designing on your 
screen. You may Print the Report Layout at 

anytime during your edit session. Then you may 
continue editing if you want. Printing the Report 
Layout will help you see exactly what your report 
form will look like on paper. In fact, you might 
want to Print Out a Report Layout before you 
actually begin Editing your Layout on the Screen. 
This will give a blank worksheet that you can use 
to help you design the form you want on paper. 



7.7 Option 3_ Look at the Record Layout 



This option will let you re-display the 
Screen/Record Layout that you are using to 
generate your Report. This is the Screen that you 
see when you first started the program. You would 
use this option whenever you need to refer to your 
Record for information about the Fields. You can 
Look at your Screen Layout while you are editing 
and then you may continue editing. 
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7.8 Option _4 Done 



When you have finished, simply enter the letter D 
for Done when you are asked to enter your options. 
If you enter D, then you will continue on to the 
next phase of the program. 



NOW, You should skip the next section of this 
manual which applies to Columnar Reports Only and 
go to Section 7.15, Naming your Report Program. 
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7.9 Step 3b— Columnar Reports 



If you picked the Columnar Report as your choice 
for the type of Report you want then you should 
follow this section. If you are designing a Free 
Form Report then you should consult the previous 
section on Free Form Reports. 



7 -*Q Eliminating Fields (Data) From the Report 



Once your Screen File has been found, you will see 
the Screen/Record Layout that you designed when 
you created your original filing program. All of 
the fields will be numbered. 



You will then be asked if you want to eliminate 
any Fields from the Report. This means that if you 
eliminate a Field, then it will not be printed on 
your reports. You should enter the Field numbers 
that you want to eliminate one by one. As you 
eliminate a field, the screen will display the '*' 
character in the Field that you picked to let you 
know that it has been eliminated. 



When you are done, simply enter the letter N for 
No when you are asked the question "Do you want 
to eliminate any more Fields from the Report ?". 
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7.11 Report Headings & Titles 



Each report should have headings at the top of 
each page to identify those items listed in the 
Report. In this step you will enter a heading for 
each Field in your report. This heading will appear 
at the top of each column on your printed reports. 



Example: 



Name 


List 


of Friends 

Page 1 
Address 


Date 01/01/83 
Phone 


JIM 
BOB 
TOM 




Box 1 
Box 2 

1 st Street 


333-3344 
334-1234 
456-1234 



The words Name, Address and Phone in the example 

above, are the Field headings. The heading will be 

printed at the top of each page on your printed 
reports. 



In addition to a heading for each Field column that 
you will be printing, you may enter a Report Title. 
This Report Title will appear above the Field 
Column Headings. The Report Title is a Name or 
Description of what the Report contains. 
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In the Example shown above, the Report Title is 
"List of Friends". 



You will notice a Page Number and Date also 
appears in the Example between the Report Title 
and Field Headings. The Page Number and Date 
are automatically included in your report programs 
for you. (Date will only be included if your 
computer has the proper date function). The page 
number will be incremented automatically as your 
created program is printing. The date that will be 
displayed is the System Date. 



When you are ready to enter the Report Title, 
Press ENTER when asked to at the bottom of the 
screen. Then type in the Report Title that you 
want. 



(c) 1981,1982 ICR FutureSoft 57 



7.12 The Report Width 



At this point in the program you will be asked: 



What is your Report Width (i.e. Max. No. of 
characters per line) Default 80 



You may enter a number between 1 and 131. If 
you do not enter a number and you press the 
ENTER Key then the default value of 80 will 
automatically be used. The number you enter will 
be the maximum width (line length) permitted on 
any line of your report. Most 8 1/2 inch wide 
paper would permit a maximum line length of 65. 
This would leave a nice right hand margin, although 
you may print a full 80 characters across on an 8 
1/2" wide paper and there would be no margin. 
Most 1*" wide computer printout paper would 
permit a maximum width of 131 characters. 



Remember though, that you can choose any width 
between 1 and 131, or simply press ENTER and 80 
will be assigned automatically. 



PLEASE Note: We have supplied a chart in the 
next Step which will tell you what to set your 
width at for different sizes of paper and labels. 
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7.13 Number of Lines per Page 



The next step permits you to specify how many 
lines you want your Report Program to print on 
each page of your report. 



Most 8 1/2 x li paper will permit 66 lines to be 
printed. If you should be using 11 inch long paper, 
you would not normally want to specify 66 lines as 
the number you want to print because some room 
on the page will be needed to print your Report 
Title and Column Headings. For 11 inch long paper 
you should specify 50 lines as your page length. 
This wiii give you a nice top and bottom margin 
and provide adequate room for your Title and Field 
Headings at the top of the report. 

When the message... 

How many lines do you want to print on a page? 

... appears on your screen, simply enter the number 
of lines that you want to print on each page. 
Don't forget that there will be a Title and Heading. 
If you do not enter a number and simply Press the 
Enter Key, then the default value of 50 lines per 
page will be used. 
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The chart below will tell you how to answer the 
questions for Report Width and Length for various 
sizes of paper. 



CHART for Printing a REPORT with Title and 
Headings. 



If Your Paper 

is... 



Then YOU ENTER 
this ... 



Width Length Width Length 

(inches) (char.) (lines) 



8 1/2 11 
(letter size) 

8 1/2 1* 
(legal size) 

14 11 

(print out paper) 



65 



65 



131 



50 



65 



50 
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7.1* Total Fields 



Your report programs may contain Totals of 
Numbers. These Totals will be Printed at the End 
of your report programs. You may get Totals on 
any Numeric Field. 



To specify which fields you want to print totals 
for, simply answer Y for Yes to the question: 

Do You want to Total any Fields (Y/N) - 

... then enter the Field Numbers of those Fields 
that you want Totals for. When you have selected 
a Field to be Totaled, the letter "T" will be 
displayed in the Field. If you choose a Field that is 
not a Number (Numeric) Field, then you will get a 
message telling you that the Field that you picked 
can't be totaled because it is non-numeric. 



When you have finished picking the Fields that you 
want totaled, simply Press the ENTER Key when 
you are asked to enter a Field Number. You will 
then be asked ... 

Are you Done (Y/N) ? 

If you answer Y for Yes then you go to the next 
Step. If you answer N for No then you will be able 
to continue entering more Field Numbers for 
totaling. 
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7,15 Step 4-- Naming Your Report Program 



At this point you will be asked to give your report 
program a name just as you did when you created 
your Filing and Data Entry Programs before. The 
Name may contain a maximum of 8 characters. 



When you haye entered the Name, then enter the 
Drive Code that you want to use to create your 
program on, You will be asked on the Screen to 
enter the Drive Code. 
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8.0 USING YOUR NEW REPORT PROGRAM 



The Report Programs that you created with the 
QUIKPRINT Report Program Generator operate in 
much the same way as do the Filing Programs that 
you created with QU1KPRO+. 



Report programs let you print the entire report ? 
i.e. ail information that you have in a file or only 
certain records that you want in the report. 



LOAD and RUN the Report Program by the Name 
that you assigned it. Remember that your report 
program will print that data that you have stored 
in a file you prepared previous to running the 
report. The report program cannot print anything 
if the File does not exist or you have no 
information in the file. The File that your report 
uses is the same file of Data that you used in the 
original QUJKPRO+ File Handling Program you 
created. 

Once your report program has started, the name of 
the file that the report is being produced from is 
displayed at the top of your computer screen. 

At the bottom of the screen , you are given the 
options: 



(G)et, (S)earch, Sort, Select, (E)nd 

If you specify (G)et, then you will be asked for the 
Key that you want for records to be printed in 
your report. Your report will only contain those 
records which have as their key the key you 
specified. Your Key is the Key that you specified 
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in your original QUIKPRO+ Filing Program. 
8.1 Selecting Records For Your Report 

If you specified Search, Sort, Select then you may; 

1= Print only those records in the 
file containing the information you 
want to Search for. ( String Search ) 

2. Print only those records in the 
file where a PARTICULAR FIELD 
contains the information you want 
to Search for. ( Field Search ) 

3. Print only those records where a 
numeric field is Less Than, 
Greater Than, or Equal To a 
number that you enter. 

( Select or Relational Search ) 

4. Print ALL the records in your file. 

5. Any of the above printed in Sorted 
order either numerically or 
alphabetically. 

6. Any of the above printed in the order 
the records appear in the Master File. 



After you have entered "S" for "Search" you will 
be asked : 



Do you want to Search for something in a 
<F>ield or <A>nywhere in the file - 
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Searching "Anywhere" in the File 



If you enter "A" for "Anywhere in the file" you 
will be asked : 

" Search for ? - " 

You may enter any characters or numbers that 
you want to Search for, then press ENTER. 
This will Select all records that contain the 
numbers or characters that you entered. If you 
simply press ENTER instead of entering 
characters to Search for, you will be asked : 

"Print All Records ? (Y/N) - " 

If you reply "Y" for YES, all records will 
be selected. If you reply "N" for NO, you will be 
returned to the Report Program Menu. 



Searching a "Field" 



IF YOU ENTER "F" for "FIELD" you will be asked 
to : 

"Press ENTER to get to the Field you 
want to Search on ... " 

"When you are the Field you we it, type in 
what you want to Search for. " 

For example, if you wanted to Print all records 
that contain "SMITH" in the NAME field, then 
press ENTER until the cursor is at the name field 
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and type in "SMITH". You may notice that while 
pressing ENTER to get to a particular field that 
the cursor will skip "DISPLAY ONLY" calculation 
fields. This is because you cannot Select on 
"DISPLAY ONLY FIELDS". See NOTE below. If 
the field you select is a NUMERIC field then you 
will only be able to type in numbers. If the field 
is a numeric field you will be told: 

"The Field you are Searching is a Number 
Field ..." 

"You may Select Records that are ... " 

"<E>quaI, <L>ess or <G>reater than the 
number you entered (Pick E,L or G) - " 



By replying "E", "L" or "G" 5 only those 
records whose Field you selected is Equal To, Less 
Than or Greater Than the value you typed 
in will be selected. 



8.2 Sorting Your Report 



After Selecting the records you want to print 
in your Report you will be asked : 

"Do you want your Report in sorted order ? 
(Y/N)-" 

If you reply "N" for NO, then your Report will 
be printed in the order of the Master File. If 
you reply "Y" for YES, then your Fields will be 
numbered automatically on your screen. You will 
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then be asked: 

"What Field do you want to Sort on ? - " 

Simply enter the number of the field you want 
to Sort on. If the field is a numeric field then 
your Report will be Sorted in Numeric order. If the 
field is not a number field then your Report will 
be in Alphabetical order. You will notice that if 
your file contains DISPLAY ONLY FIELDS, the 
fields will not be numbered on the screen. This is 
because you cannot Sort on "DISPLAY ONLY 
FIELDS". See NOTE below. 

After entering the Field number you want to Sort 
on, your program will load and run the 
QUIKPRO+ Sort. When the Sort has been 
completed it will reload your Report program 
and print your Report. While your Report is 
printing you may : 

"<P>ause, <A>bort, <R>edo ... " 

Pressing the corresponding letter will PAUSE 
the printing of your Report, ABORT the printing 
of your Report or REDO your Report from the 
top. This is especially convenient if you have a 
paper jam or other printer problems. 



(c) 1981,1982 ICR FutureSoft 67 



When the Report has completed printing you will 

be asked : 

"Do you want to Print another copy ? (Y/N) 



If you reply "Y" for YES, then another copy of 
your Report will be printed. If you reply "N" for 
NO, then you will be returned to the Report 
Program Menu. 



NOTE: You may only Sort and Select on fields 
that are STORED in the Master File, that is, 
fields that are not defined as Display Only fields 
when creating a program with QU1KPRO+. If you 
want to Sort or Select on a calculation field 
then you must define it as <S>tored when 
creating your program with QUIKPRO+ , 
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8.3 QUIKPRO+ SORT Technical Information 

Sort Operation 

The following information is technically oriented 
and is provided to give the user a general view 
of the Sort Error Codes and Parameter file. 
Reading this section is not required to use 
QUIKPRO+ or its created programs. 

The QUIKPRO+ Sort program is written onto your 
disk when your Report program is created. 
The Sort consists of two files. These files are 
"SORT.V10" and "SRTOV3.V10". These files are, 
respectively, the Sort program and the machine 
language Sort module. Both of these files must 
be present on the Report program disk if the 
Sort is to be used. If "SORT.V10" is not 
present on the disk, the Report program will 
not ask "Do you want your Report in sorted 
order ? (Y/N) - " . NOTE: The Sort and Report 
programs must be on the DEFAULT or CURRENTLY 
LOGGED Drive in CP/M and MSDOS systems to run 
properly ! 



QUIKPRO+ Sort Parameter File 

After using the <S>earch, <S>ort and <S>eIect 
option in the Report Program and replying "Y" to 
the Sort option, the Report program will write 
files to the disk that pass information to the Sort. 
One of these files is called the Sort Parameter 
File. The file name is your Report program name 
with the extension ".SRT" or "/SRT" . This 
parameter file contains information that the 
Sort needs to function properly. All the 
parameters are defined automatically when your 
Report programs are created. Some of these 
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parameters can be modified in your created 
program to suit your particular sorting needs. 
The Sort parameters are defined beginning at Line 
*53i5 in the created Report Program. 
: The parameters are: 

i. REPORT PROGRAM NAME 

2. MASTER FILE NAME ( with drive spec ) 

3. WORKSPACE DRIVE 

». SORTED KEY FILE DRIVE 

5. PROMPT CURSOR POSITION 

6. RECORD LENGTH 

7. SORT FIELD RECORD POSITION 

8. SORT FIELD LENGTH 

9. ALPHA OR NUMERIC SORT 

10. DECIMAL PRECISION 



Most parameters are best left unmodified. 
The parameters that will be dealt with here are 
the DRIVE and PRECISION parameters. Any 
further modification may produce unpredictable 
results. 



W orkspace Drive Parameter 

Before the Sort actually Sorts and Selects 

records from your Master File It must read and 
load sort fields from selected records into 

memory. The Sort will allocate as much memory 
as possible to sort your file. If you do not have 
enough memory to Sort all the selected records 
the Sort must perform a Sort/Merge. That is, 
read and sort a block of records, write them 
out to a temporary file, read and sort another 
block of records and merge them with the 
sorted block of records on the disk. In order 
for this to occur the Sort will need a disk drive 
for this temporary workspace. The Drive it uses 
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is defined by this parameter. You may change 
Line 45325 to use any online drive for 
workspace. This parameter is normally set to Drive 
"A" or Drive "0" in your created Report Program. 
In most cases a Merge is not necessary. The Sort 
can handle about 1500 records with a 15 to 20 
byte Sort key on a 64k CP/M or MSDOS system or 
a 48k TRSDOS system without doing a MERGE. If 
a Merge is necessary it will take significantly 
more time to accomplish the sort. If there is not 
enough workspace on the Drive then a Disk Full 
error will occur and you will be returned to the 
Report Program. 



Sorted Key File Drive Parameter 

The Sorted Key File is the file that contains 
the record numbers of the selected records in 
sorted order. The Report Program uses this file 
to print your report. The Sort program writes 
this file to the drive indicated by this 
parameter. You may change this parameter in 
Line 45330 to suit your disk space needs. It is 
normally set to Drive "A" or Drive "0" in your 
created Report Program. 

If your QUIKPRO+ Created Programs are on Drive 
"A" or Drive "0" with space to spare, and your 
Data File is on Drive "B" or Drive "1", then it 
will be unlikely for a Disk Full Error to occur. 
If your Programs and Data File are, all on Drive 
"A" or Drive "0" and there is not ample work 
space on the disk, then changing these parameters 
to use another drive may be necessary. 



Decimal Precision Parameter 

This parameter is used only if the QUIKPRO+ Sort 
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is performing a NUMERIC sort. This parameter 
defines how accurate the sort is to the right of 
the decimal point. This parameter may be set from 
to 4. If "0" is specified, all digits to the right of 
the decimal point are ignored during the sort. This 
parameter is normally set for 2. This is the 
normal setting for "DOLLARS AND CENTS" sorting 
(0000.00). You may change this parameter to 
0,1,2,3 or 4 by changing Line 45360 in your 
created Report program. 



8.4 QUIKPRO+ Sort Error Codes 

The QUIKPRO+ Sort will return its own Error Code 
if any problems occur during the Sort that inhibit 
its successful completion. When an error occurs, the 
Sort will display the Error Code on the bottom 
of the screen with a general explanation of the 
problem. If an UNDEFINED ERROR occurs then the 
Sort will return a BASIC error code. BASIC error 
codes are displayed with a DASH or "-" preceding 
the code number. Most errors will return you to 
the Report program. 

ERROR CODE EXPLANATION 

1 Bad Sort Field POSITION or LENGTH 
parameter . 

2 Bad SORT MODE parameter. This 
parameter must be set to ZERO or 
ONE. l=numeric 0=alpha 

7 Bad file name. This may be a bad 
Master File name or Program name. 

8 Bad drive specification. Specifying 
an invalid drive or appending an 
invalid drive to a file name such as 
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the Report Program name, Master File 
name etc.. 

17 The machine language sort module 
"SRTOV3.V10" is not on your disk. 

18 Master File not found or there are 
no records in your Master File. 
Make sure your Master File Disk is 
in its proper drive. 

19 Insufficient memory. This error 
should not occur. This will only 
happen if there is not enough memory 
available to accomplish a sort. 

20 Calling Program not found. The sort 
could not find your Report Program. 
If this error occurs, the Sort will 
not be able to return to the Report 
program. Make sure the Report Program 
is in the default, or currently 
logged drive. 

21 DISK FULL while writing the SORTED 
KEY FILE. Delete unnecessary files 
from your disk or change the SORTED 
KEY FILE PARAMETER in your Report 
Program. 

22 DISK FULL while using temporary 
workspace during a MERGE. Delete 
unnecessary files from your disk or 
change the WORKSPACE DRIVE parameter 
in your Report Program. 

23 DISK FULL while writing the KEYCMD 
file to your disk. This file tells 
your Report program which SORTED 
KEY FILE to use and Reports any 
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ERROR incurred during the Sort. 
Delete unnecessary files from your 
Report Program Disk. 

24 BAD MASTER FILE or PARAMETERS DO NOT 
MATCH .MASTER FILE. 

25 BASIC not opened with 3 file buffers. 
When bringing up BASIC under TRSDOS 

type " BASIC -F:3v ". CP/M and MSDOS 
default to 3 file buffers. 

26 I/O ERROR. This Is caused by a disk 
read or write error. This is usually 
caused by a bad disk or disk drive 
problems . 

255NO SELECTED RECORDS. No records were 
selected based on the 
Select ion criteria 
you defined in the Report Program. 

-xxUNDEFINED ERROR. Any errors not 
handled by the sort will return a 
BASIC error code, preceeded by a 
DASH or "-». 
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9.0 Q UIKIN DEX FIL E INDEXING U TILIT Y 
PROGRAM (O ptional-N ot R equired) 



If you already have file Data that you 
have created from a program other than 
one you wrote using QUIKPRO + , then the 
QUIKINDEX Utility Program can be used to 
make your data accessible by programs 
that you create with QUIKPRO + . 

In order to use the Data that you already 
have in some other file, you must put the 
Data File that you have in your computer 
system and run the QUIKINDEX Utility 
Program. 

After you have selected the QUIKINDEX 
Utility Program from the Program Menu, 
the QUIKINDEX Program will ask you to: 



"Enter the Name of the File that 
want to Index-" 

Enter the Name of the File. 



you 



If QUIKINDEX cannot find your file, then 
a message telling you that your file 
cannot be found will be displayed. 
Remember that in order to produce the 
Index for a File, the File must be in the 
system at the time the QUIKINDEX Utility 
is being used. 

If you have entered a good File Name and 
QUIKINDEX finds the File, QUIKINDEX will 
ask you the starting position for the index 
in the File. 
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Next you wlil be asked to enter the 
ending position for the Key in your File. 
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HOW DO YOU KNOW WHERE THE KEY IS 
IN YOUR FILE??? 

You must know what your record layout is 
like in the File that you are using to 
create your index. For Example if your 
Record contains an account number in it 
and the first number in the account 
number starts at position 1 in your File 
Record, then 1 would be the starting 
position of your Key, if you were using 
the account number as the Key. If the 
account number in your file ended at 
position 5 in your File Record, then you 
would enter position 5 as the ending 
position for the Key. So, in other words, 
if you want a particular item in your File 
Record to be used as the Key using the 
QUIKINDEX Utility, you must know where 
the item you want to use as the key is 
positioned in your File Record. 



After you have entered the starting and 
ending position of the Key, then you will 
be asked to: 



"Enter the length of the File Record" 
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You should enter the length of your file's 
record at this point. The length you 

should enter is the total length of one 
record in your file. If your file has three 
fields of information: 



Name Field is 10 characters long in 
your Record 

Age Field is 5 characters long in 
your Record 

Sex Field is 1 character long in your 
Record 



... then the total length of your record in 
the above example is 16. 

You must know the length of the File 
Record to Proceed with the Index Utility 

Program. 
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NOTE: 

THE QUIKINDEX UTILITY PROGRAM 
IS ONLY PROVIDED FOR THE 
PURPOSE OF BEING ABLE TO MAKE 
OTHER FILES COMPATIBLE. WITH 
PROGRAMS WRITTEN WITH 
QUIKPRO + . QUIKINDEX IS NOT 
REQUIRED FOR NORMAL QUIKPRO + 
PROGRAM OPERATION AS DISCUSSED 
IN PREVIOUS SECTIONS OF THIS 
MANUAL. 



Files which are indexed using the 
QUIKINDEX Utility Program must be non- 
compressed ASCII Files. No numeric 
compression variables are allowed. 
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QMM i!E!?:ENCE SECTION 
(APPENDIX) 



Follow 'the Steps Listed Below? 

1, Bring up BASIC in your Computer, 

2, Enter RUN "QUIKMENU" 



I r s f p 



:aK 



4. Specify prime key by entering the 
field number of the desired field. 

5. Specify which fields are to be 
Numeric (Number) Only by entering 
the field number. Assign the Format 
for each Numeric Only Input Field. 
Enter Field Comments. 

6. Give your Data File a name. 

7. Give your New Program a Name. 

8. When your new Program Runs for 
the first time, specify the maximum 
number of records that you want to 
have in the Data File, Then specify 
the Diskette or Disk Drive that you 
want the Data File to be placed on. 

9. Your New Program is ready to 
use, 

10. To RUN your new Program simply 
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follow the instructions for RUNNING 
BASIC Programs in your own BASIC 
Manual supplied with your Computer. 



In most cases you can RUN your NEW 
Program by typing in RUN and your 
program name. 

Example: RUN "MYPROG" will RUN 
the Program named MYPROG. 
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